shared source/sscli_ref_20021101/docs/System.Runtime.Remoting/System.Runtime.Remoting.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html>
   2 <head>
   3 <META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   4 <link rel="stylesheet" type="text/css" href="../refdoc.css">
   5 <title>Namespace: System.Runtime.Remoting</title>
   6 </head>
   7 <body>
   8 <h2>Namespace: System.Runtime.Remoting</h2>
   9 <dl>
  10 <dd>
  11 <p> The  <a href="../System.Runtime.Remoting/System.Runtime.Remoting.html">System.Runtime.Remoting</a> namespace provides classes and interfaces that allow developers to create and configure distributed applications. Some of the more important classes of the  <a href="../System.Runtime.Remoting/System.Runtime.Remoting.html">System.Runtime.Remoting</a> namespace are the  <a href="../System.Runtime.Remoting/types/RemotingConfiguration.html">RemotingConfiguration</a> class, the  <a href="../System.Runtime.Remoting/types/RemotingServices.html">RemotingServices</a> class, and the  <a href="../System.Runtime.Remoting/types/ObjRef.html">ObjRef</a> class.</p>
  12 <p> The  <a href="../System.Runtime.Remoting/types/RemotingConfiguration.html">RemotingConfiguration</a> class contains static methods for interfacing with configuration settings. The  <a href="#Configure">RemotingConfiguration.Configure</a> method allows developers to configure the Remoting infrastructure through the use of XML formatted configuration files. The  <a href="../System.Runtime.Remoting/types/RemotingConfiguration.html">RemotingConfiguration</a> class also contains several methods for client-end and server-end registration of client and server activated objects that reside on the server.</p>
  13 <p> The  <a href="../System.Runtime.Remoting/types/RemotingServices.html">RemotingServices</a> class provides a number of methods to help in using and publishing remoted objects. The  <a href="#Marshal">RemotingServices.Marshal</a> method provides the functionality for storing all the relevant information required to activate and communicate with a remote object in an instance of the  <a href="../System.Runtime.Remoting/types/ObjRef.html">ObjRef</a> class for later serialization and transmission to a remote location. The  <a href="#Unmarshal">RemotingServices.Unmarshal</a> method reverses this process, creating a proxy for a remote object that can be used by an application without regard for any remoting subdivisions.</p>
  14 <p> The  <a href="../System.Runtime.Remoting/types/ObjRef.html">ObjRef</a> class holds all the relevant information required to activate and communicate with a remote object. This class is a serializable representation of an object that is transmitted to a remote location using a channel, where it is unmarshaled (see  <a href="#Unmarshal">RemotingServices.Unmarshal</a>) and can be used to create a local proxy of the remoted object.</p>
  15 </dd>
  16 </dl>
  17 <h3>Members of System.Runtime.Remoting Namespace</h3><b>Classes</b><dl>
  18 <dd>
  19 <table border="1" width="90%" style="border-collapse: collapse">
  20 <tr valign="top">
  21 <th bgcolor="#C0C0C0">Class</th>
  22 <th bgcolor="#C0C0C0">
  23                                                         Description
  24                                                 </th>
  25 </tr>
  26 <tr valign="top">
  27 <td width="30%"><a href="types/ActivatedClientTypeEntry.html">class ActivatedClientTypeEntry</a></td>
  28 <td width="60%"> Holds values for an object type registered on the client end as a type that can be activated on the server.
  29      </td>
  30 </tr>
  31 <tr valign="top">
  32 <td width="30%"><a href="types/ActivatedServiceTypeEntry.html">class ActivatedServiceTypeEntry</a></td>
  33 <td width="60%"> Holds values for an object type registered on the service end as one that can be activated on request from a client.
  34      </td>
  35 </tr>
  36 <tr valign="top">
  37 <td width="30%"><a href="types/InternalRemotingServices.html">class InternalRemotingServices</a></td>
  38 <td width="60%"> Reserved class for internal use only.
  39      </td>
  40 </tr>
  41 <tr valign="top">
  42 <td width="30%"><a href="types/ObjectHandle.html">class ObjectHandle</a></td>
  43 <td width="60%"> Wraps marshal by value object references, allowing them to be returned through an indirection.
  44      </td>
  45 </tr>
  46 <tr valign="top">
  47 <td width="30%"><a href="types/ObjRef.html">class ObjRef</a></td>
  48 <td width="60%"> Stores all relevant information required to generate a proxy in order to communicate with a remote object.
  49      </td>
  50 </tr>
  51 <tr valign="top">
  52 <td width="30%"><a href="types/RemotingConfiguration.html">class RemotingConfiguration</a></td>
  53 <td width="60%"> Provides various static methods for configuring the remoting infrastructure.
  54      </td>
  55 </tr>
  56 <tr valign="top">
  57 <td width="30%"><a href="types/RemotingException.html">class RemotingException</a></td>
  58 <td width="60%"> The exception that is thrown when something has gone wrong during remoting.
  59      </td>
  60 </tr>
  61 <tr valign="top">
  62 <td width="30%"><a href="types/RemotingServices.html">class RemotingServices</a></td>
  63 <td width="60%"> Provides several methods for using and publishing remoted objects and proxies. This class cannot be inherited.
  64      </td>
  65 </tr>
  66 <tr valign="top">
  67 <td width="30%"><a href="types/RemotingTimeoutException.html">class RemotingTimeoutException</a></td>
  68 <td width="60%"> The exception that is thrown when the server or the client cannot be reached for a previously specified period of time.
  69      </td>
  70 </tr>
  71 <tr valign="top">
  72 <td width="30%"><a href="types/ServerException.html">class ServerException</a></td>
  73 <td width="60%"> The exception that is thrown to communicate errors to the client when the client connects to non .NET Framework applications that cannot throw exceptions.
  74      </td>
  75 </tr>
  76 <tr valign="top">
  77 <td width="30%"><a href="types/SoapServices.html">class SoapServices</a></td>
  78 <td width="60%"> Provides several methods for using and publishing remoted objects in SOAP format.
  79      </td>
  80 </tr>
  81 <tr valign="top">
  82 <td width="30%"><a href="types/TypeEntry.html">class TypeEntry</a></td>
  83 <td width="60%"> Implements a base class that holds the configuration information used to activate an instance of a remote type.
  84      </td>
  85 </tr>
  86 <tr valign="top">
  87 <td width="30%"><a href="types/WellKnownClientTypeEntry.html">class WellKnownClientTypeEntry</a></td>
  88 <td width="60%"> Holds values for an object type registered on the client as a well-known type object (single call or singleton).
  89      </td>
  90 </tr>
  91 <tr valign="top">
  92 <td width="30%"><a href="types/WellKnownServiceTypeEntry.html">class WellKnownServiceTypeEntry</a></td>
  93 <td width="60%"> Holds values for an object type registered on the service end as a well-known type object (single call or singleton).
  94      </td>
  95 </tr>
  96 </table>
  97 </dd>
  98 </dl><br><b>Interfaces</b><dl>
  99 <dd>
 100 <table border="1" width="90%" style="border-collapse: collapse">
 101 <tr valign="top">
 102 <th bgcolor="#C0C0C0">Interface</th>
 103 <th bgcolor="#C0C0C0">
 104                                                         Description
 105                                                 </th>
 106 </tr>
 107 <tr valign="top">
 108 <td width="30%"><a href="types/IChannelInfo.html">interface IChannelInfo</a></td>
 109 <td width="60%"> Provides custom channel information that is carried along with the  <a href="../System.Runtime.Remoting/types/ObjRef.html">ObjRef</a>.
 110      </td>
 111 </tr>
 112 <tr valign="top">
 113 <td width="30%"><a href="types/IEnvoyInfo.html">interface IEnvoyInfo</a></td>
 114 <td width="60%"> Provides envoy information.
 115      </td>
 116 </tr>
 117 <tr valign="top">
 118 <td width="30%"><a href="types/IObjectHandle.html">interface IObjectHandle</a></td>
 119 <td width="60%"> Defines the interface for unwrapping marshal by value objects from indirection.
 120      </td>
 121 </tr>
 122 <tr valign="top">
 123 <td width="30%"><a href="types/IRemotingTypeInfo.html">interface IRemotingTypeInfo</a></td>
 124 <td width="60%"> Provides type information for an object.
 125      </td>
 126 </tr>
 127 </table>
 128 </dd>
 129 </dl><br><b>Enumerations</b><dl>
 130 <dd>
 131 <table border="1" width="90%" style="border-collapse: collapse">
 132 <tr valign="top">
 133 <th bgcolor="#C0C0C0">Enumeration</th>
 134 <th bgcolor="#C0C0C0">
 135                                                         Description
 136                                                 </th>
 137 </tr>
 138 <tr valign="top">
 139 <td width="30%"><a href="types/WellKnownObjectMode.html">enumeration WellKnownObjectMode</a></td>
 140 <td width="60%"> Defines how well-known objects are activated.
 141      </td>
 142 </tr>
 143 </table>
 144 </dd>
 145 </dl><br><b>Namepace hierarchy</b><br><ul class="none">
 146 <li><a href="../System/types/Object.html">System.Object</a></li>
 147 <ul class="none">
 148 <li><a href="../System/types/Exception.html">System.Exception</a></li>
 149 <ul class="none">
 150 <li><a href="../System/types/SystemException.html">System.SystemException</a></li>
 151 <ul class="none">
 152 <li><a href="../System.Runtime.Remoting/types/RemotingException.html">System.Runtime.Remoting.RemotingException</a></li>
 153 <ul class="none">
 154 <li><a href="../System.Runtime.Remoting/types/RemotingTimeoutException.html">System.Runtime.Remoting.RemotingTimeoutException</a></li>
 155 </ul>
 156 </ul>
 157 <ul class="none">
 158 <li><a href="../System.Runtime.Remoting/types/ServerException.html">System.Runtime.Remoting.ServerException</a></li>
 159 </ul>
 160 </ul>
 161 </ul>
 162 <ul class="none">
 163 <li><a href="../System/types/MarshalByRefObject.html">System.MarshalByRefObject</a></li>
 164 <ul class="none">
 165 <li><a href="../System.Runtime.Remoting/types/ObjectHandle.html">System.Runtime.Remoting.ObjectHandle</a> --- <a href="../System.Runtime.Remoting/types/IObjectHandle.html">System.Runtime.Remoting.IObjectHandle</a></li>
 166 </ul>
 167 </ul>
 168 <ul class="none">
 169 <li><a href="../System.Runtime.Remoting/types/ObjRef.html">System.Runtime.Remoting.ObjRef</a> --- <a href="../System.Runtime.Serialization/types/IObjectReference.html">System.Runtime.Serialization.IObjectReference</a>, <a href="../System.Runtime.Serialization/types/ISerializable.html">System.Runtime.Serialization.ISerializable</a></li>
 170 </ul>
 171 <ul class="none">
 172 <li><a href="../System.Runtime.Remoting/types/RemotingConfiguration.html">System.Runtime.Remoting.RemotingConfiguration</a></li>
 173 </ul>
 174 <ul class="none">
 175 <li><a href="../System.Runtime.Remoting/types/RemotingServices.html">System.Runtime.Remoting.RemotingServices</a></li>
 176 </ul>
 177 <ul class="none">
 178 <li><a href="../System.Runtime.Remoting/types/SoapServices.html">System.Runtime.Remoting.SoapServices</a></li>
 179 </ul>
 180 <ul class="none">
 181 <li><a href="../System.Runtime.Remoting/types/TypeEntry.html">System.Runtime.Remoting.TypeEntry</a></li>
 182 <ul class="none">
 183 <li><a href="../System.Runtime.Remoting/types/ActivatedClientTypeEntry.html">System.Runtime.Remoting.ActivatedClientTypeEntry</a></li>
 184 </ul>
 185 <ul class="none">
 186 <li><a href="../System.Runtime.Remoting/types/ActivatedServiceTypeEntry.html">System.Runtime.Remoting.ActivatedServiceTypeEntry</a></li>
 187 </ul>
 188 <ul class="none">
 189 <li><a href="../System.Runtime.Remoting/types/WellKnownClientTypeEntry.html">System.Runtime.Remoting.WellKnownClientTypeEntry</a></li>
 190 </ul>
 191 <ul class="none">
 192 <li><a href="../System.Runtime.Remoting/types/WellKnownServiceTypeEntry.html">System.Runtime.Remoting.WellKnownServiceTypeEntry</a></li>
 193 </ul>
 194 </ul>
 195 <ul class="none">
 196 <li><a href="../System/types/ValueType.html">System.ValueType</a></li>
 197 <ul class="none">
 198 <li><a href="../System/types/Enum.html">System.Enum</a></li>
 199 <ul class="none">
 200 <li><a href="../System.Runtime.Remoting/types/WellKnownObjectMode.html">System.Runtime.Remoting.WellKnownObjectMode</a></li>
 201 </ul>
 202 </ul>
 203 </ul>
 204 </ul><br><i><a href="../documentation_license.txt">
 205                                   Copyright (c) 2002 Microsoft Corporation.  All rights reserved.
 206                                 </a></i></body>
 207 </html>